	<html>
		<head>
			<title>Installation Guide</title>
		</head>
		<body>
		<h1>Introduction</h1>
		<p>Whole project is implemented so that it can be hosted as a web application. There are some third party components required to perform some of the conversions. This installation guide will outline how the web application can be installed so that every conversion will work.</p>
		
		<h1>Installations</h1>
		
		<h3>Installing FWTools</h3>
		
		<p>First let's install FWTools. This is useful during shape file conversion and for geotiff conversion.</p>
		<ol>
			<li>Download FWTools from <a href="http://home.gdal.org/fwtools/FWTools-linux-2.0.6.tar.gz">here</a>. </li>
			<li>Unpack the downloaded FWTools distribution, run the install.sh script in the new directory, and then add the bin_safe directory to your path.<br /> <br />
			<font size="3" face="Courier">% tar xzvf FWTools-linux-0.9.5.tar.gz <br />
			% cd FWTools-linux-0.9.5 <br />
			% ./install.sh</font>
			<p>If you use Bash as your shell add the following to your startup script (ie. ~/.bash_profile): <br/><br/>
	         <font size="3" face="Courier">PATH=$PATH:$HOME/FWTools/bin_safe</font> </br><br/>
	       or if you use csh or tcsh as your shell add the following to your .cshrc: </br><br/>
	         <font size="3" face="Courier">setenv PATH $PATH:$HOME/FWTools/bin_safe</font> <br /><br/>
	       For more information check <a href="http://fwtools.maptools.org/linux-main.html">installation guide</a> of FWTools. </p>	
			</li>	
		</ol>
		
		<h3>Checkout Project Source</h3>
		
		<p>If you don't have the latest code of our project, check out the latest source from Google codes. Information on checking out our source code can be found <a href="http://code.google.com/p/kml-soc-ncsa/source/checkout">here</a>. </p>
		
      <h3>Installing Python Scripts for GeoTIFF to KML Conversion</h3>
      
      <p>GeoTIFF to KML conversion uses a python script created within FWTools project. For some reason, this python scripts doesn't come with the above distribution. It is bundled within our project and uses a small script to run it with proper parameters. We need to provide the location of the script (the python script should be in the same folder as this script). Also we need the location of the FWTools installation, as our python script needs some python modules come with FWTools installation. </p>
      <p>Goto the web module and find web.xml ($PROJECT_HOME/modules/web/web/WEB-INF/web.xml). Set proper values for <b>GeoTIFFScript</b>, <b>FWToolsHome</b> and <b>TempFolder</b> parameters within the web.xml and save it. </p>	
      
      <h3>Building from Source</h3>
      
      <p>You should have <a href="http://ant.apache.org/manual/install.html">Apache ant</a> installed within your system. </p>
      
      <p>Goto each module (common, tekml and web in that order) and build the modules using ant. </p>	
      
      <p><font size="3" face="Courier">
       % cd $PROJECT_HOME <br />
       % cd modules/common && ant <br />
       % cd ../modules/tekml && ant <br />
       % cd ../modules/web && ant <br />
      </font></p>
		
      <h3>Deployment</h3>
      
      <p>You are now ready to deploy the system. We need a servlet container to deploy our system and it is recommended to use Apache Tomcat for this. </p>
      <p>Download <a href="http://www.devlib.org/apache/tomcat/tomcat-5/v5.5.26/bin/apache-tomcat-5.5.26.zip">Apache Tomcat</a> and install it. </p>		
		
		<p>Copy $PROJECT_HOME/modules/web/ncsakml.war in to $TOMCAT_HOME/webapps. Start tomcat and you should see our project home in http://localhost:&lt;Port&gt;/ncsakml/</p>
		</body>
	</html>